Function            inkeycdv - get a key, any alphabetics
                                     capitalized, DESQview aware

  Syntax              int inkeycdv(boolean wait);

  Prototype in        keyboard.h

  Remarks             inkeycdv returns the key code of the key pressed.
                      If no key was pressed (WAIT = FALSE) 0 is returned.
                      Any letters detected are capitalized before being
                      returned. This function is similar to getchar()
                      except input is not echoed to the screen and inkeyc
                      will detect any key press (any standard keypress.
                      It cannot distinguish between the grey '+' key and
                      the white '+'. This function is interrupt driven.
                      It will detect ALT combinations, Del, PgUp,
                      function keys, etc., any keyboard INTerrupt
                      accepted keys.)

                      When running under DESQview, inkeydv() will free up
                      time slices while waiting for a keypress. DESQview
                      is detected by the variable _dvmajor not equal to
                      zero. DESQversion() should be invoked sometime
                      before using inkeydv().

  Return value        returns the key code of the key pressed, from 1 to
                      511, all letters are capitalized. If WAIT = FALSE,
                      and no key is pressed, zero is returned.

  See also            keycode.h
                      DESQversion(), getc_match(), getk(), getc_match(),
                      getlogical(), getyn(), inkey(), inkeyc(),
                      inkeydv(), tocapkey()

  Example             #include <keyboard.h>
                      #include <multihk.h>
                      #include <stdio.h>

                      main()
                      {
                           int c;

                           DESQversion();
                           c = inkeycdv(WAIT);
                           printf("Key code # in keycode.h: %d\n", c);
                      }